Site compagnon de Markdown & vous
Préface
Ce site1 complète l’ouvrage “Markdown & vous” publié en 2023 sur e-publish, la plateforme d’édition numérique d’ULiège Library.
L’ouvrage “Markdow & vous” présente les bases de l’utilisation de Markdown et justifie l’utilisation du mode texte comme outil d’écriture académique.
Ce complément présente une utilisation plus avancée pour la création de documents rédigés avec Markdown et transformés en fichiers pdf avec l’insertion de commandes spécifiques à LaTeX2 utilisé par Pandoc pour créer ces document au format pdf.
D’une manière générale, il y a plusieurs méthodes pour arriver à un même résultat. Quelques-unes des méthodes liées à l’écriture de documents scientifiques avec Markdown sont présentées sont présentées dans les pages qui suivent3.
Les promesses de Markdown, format texte, pour rédiger et produire des documents avec Pandoc et LaTeX sont nombreuses. La durabilité4, la simplicité et la légèreté mais surtout la possibilité de reprendre possession de notre utilisation du numérique et la maîtrise d’outils non privateurs de libertés. Il ne faut pas pour autant que ce soit au prix d’une trop grande complexité.
Les pages qui suivent proposent des solutions pragmatiques à des problèmes que l’on peut rencontrer dans l’utilisation de Markdown.
Il ne faut pas que ce choix, principalement éthique, de sobriété et d’hygiène numérique, devienne une complication supplémentaire…
Trois modèles viennent compléter le site :
Pages rédigées en Markdown (sources) et générées avec Quarto-book.↩︎
La source principale vient de huit années de pratique de cette technologie mais également la consultation approfondie de Desgraupes, B. (2019). LaTeX : Apprentissage, guide et référence. De Boeck Superieur.↩︎
Toutes les commandes ont été testées avec Pandoc 3.1.3 et TeX Live 2023/Debian.↩︎